home *** CD-ROM | disk | FTP | other *** search
Text File | 1987-12-11 | 84.4 KB | 2,265 lines |
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- On-Call (tm)
- Shareware Documentation
-
- Forest Hill Software, Inc.
-
-
-
-
-
-
-
-
-
-
-
- ALL Your Resident Programs are Just a Keystroke Away
-
-
-
-
-
-
-
- For Compaq, IBM PC, XT, AT & compatibles
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 1
-
-
-
-
-
-
- On-Call (tm)
- Shareware Documentation
-
- On-Call is a trademark belonging to Forest Hill Software, Inc.
-
-
- On-Call
- Shareware Documentation
- Copyright 1987 Forest Hill Software, Inc.
- All Rights Reserved
-
- On-Call Program, Software, and Related Materials
- Copyright 1987 Forest Hill Software, Inc.
- All Rights Reserved
-
-
-
- WARNING
-
- THIS SOFTWARE AND SHAREWARE DOCUMENTATION ARE BOTH PROTECTED BY
- WORLDWIDE AND U.S. COPYRIGHT LAW (title 17 United States Code),
- ALL RIGHTS ARE RESERVED. EACH UNAUTHORIZED REPRODUCTION AND/OR
- SALES MAY RESULT IN CRIMINAL PROCEEDINGS AND IMPRISONMENT OF UP TO ONE
- YEAR AND FINES OF UP TO $10,000 (17 U.S.C. 506). COPYRIGHT INFRINGERS
- MAY ALSO BE SUBJECT TO CIVIL LIABILITY
-
- No part of this publication may be reproduced, stored in a retrieval
- system, translated, transcribed, in any form, or by any means, whether
- manual, mechanical, electromechanical, electric, electronic, chemical,
- optical, or otherwise, without explicit written permission of Forest
- Hill Software, Inc. or the copyright owner.
-
-
-
-
-
- Forest Hill Software, Inc.
- 6689 Orchard Lake Road, Suite 267
- West Bloomfield, MI 48322
- 1-800-443-4134, (313)489-0912
- CIS ID: 76556,3335
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 2
-
-
-
-
-
- The On-Call Shareware License
- -----------------------------
-
- BY ACCEPTING AND USING THIS COPY OF ON-CALL,
- YOU AGREE TO ABIDE BY THIS LICENSE AGREEMENT
-
- The On-Call Program in this package is a proprietary product and is
- protected by Copyright law. Forest Hill Software, Inc. may only
- license the program and does so only under the following terms:
-
- On-Call, its associated files and related materials are distributed "as
- is" without warranty as to their merchantability, performance,
- suitability or fitness for any particular purpose, with limited
- warranty to return for a replacement for defect in magnetic materials
- or for a latent defect in recording or nonconformity specified in
- writing for a period of ninety days from date of purchase. To obtain
- this limited warranty you must first register with Forest Hill
- Software, Inc. or purchase a copy of On-Call.
-
- You may use this copy of On-Call during a short evaluation period,
- afterwhich you agree to either register with Forest Hill Software
- or purchase a copy of On-Call prior to continued use.
-
- You may make additional copies of this software for distribution to
- other potential users on a PRIVATE, NONCOMMERCIAL BASIS. You may not
- distribute this product in connection with any other product or service
- or charge any fees for its distribution with the exception of
- registered user groups who may charge a small fee to cover the costs of
- distribution and provided that it is distributed in unmodified original
- form. Forest Hill Software has liberal site licensing, corporate use
- and product bundling agreements available. Contact our sales office
- for further details.
-
- On-Call, its associated files and Shareware Documentation is licensed
- "AS IS", but On-Call has been designed to perform in substantial
- compliance with the related materials and documentation supplied with
- this package. If you find a "bug" or think that a change should be made
- in the program, write us. If you report a significant defect in
- performance and documentation in writing with suggested changes and
- agreement of assignment of rights to us, and if we have not corrected a
- defect within 90 days, you may return the program, including all copies
- and related materials to Forest Hill Software, Inc. and we will refund
- your money. Forest Hill Software, Inc. distributes the program without
- any copy protection so that you, the user, may easily incorporate
- On-Call and its associated files into your regular system management
- procedures. In return for this flexibility you are responsible for
- compliance with the terms of this agreement. You accept the terms of
- this agreement and the remedies described above as your only remedies.
- They will only be available to you if you return the registration form
- which follows this agreement to Forest Hill Software, Inc. within 30
- days of receiving this software. If any provision of this agreement is
- held unenforceable, the remainder of the agreement shall remain in
- force.
-
-
-
-
- 3
-
-
-
-
-
- In no event shall Forest Hill Software, Inc. or the copyright owner be
- liable to you for any damages, including any lost profits, lost savings
- or other incidental or consequential damages, either direct or
- indirect, arising out of your use or inability to use the program even
- if Forest Hill Software, Inc. or its authorized representative has been
- advised of the possibility of such damages, or for any claim by any
- other party. Some states do not allow the limitation or exclusion of
- liability for special, incidental or consequential damages in which
- case this limitation may not apply to you. In any event all remedies
- are expressly limited to the amount of money you paid to forest hill
- software, inc. No dealer, distributor or Forest Hill Software, Inc.
- employee is authorized to make any changes to this agreement or any
- other representation as to performance or terms without prior written
- officer approval.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 4
-
-
-
-
-
- On-Call Product Registration Form
- ---------------------------------
-
- Registering or purchasing a copy of On-Call provides you with some
- important benefits in addition to supporting the continued development
- of this and other Shareware products.
-
- For a purchase price of 54.95 you receive
- -----------------------------------------
- - The latest version of On-Call on official media -
- - A detailed typeset copy of the On-Call User's Manual -
- - Toll-Free technical support for a period of 1 year -
- - Automatic notification of updates and new products -
- - Low cost upgrade to the next major release of On-Call -
-
- For a registration fee of $24.95 you receive
- --------------------------------------------
- - A license to use this copy of On-Call for noncommercial use -
- - A detailed typeset copy of the On-Call User's Manual -
- - One year of free technical support -
- - Automatic notification of updates and new products -
-
- -----------------------------------------------------------------------
- To register or order your copy of On-Call, fill out and sent the
- following form to:
-
- Forest Hill Software, Inc. 1-800-443-4134
- 6689 Orchard Lake Road, Suite 267 - or call - International or MI
- West Bloomfield, MI 48322 313-489-0912
-
- Or contact us via Compuserve ID: 76556,3335
-
- ___ New Copy of On-Call ($54.95) ___ Shareware Registration ($24.95)
-
- Name _____________________________________________ Title __________
- Company ______________________________________________________________
- Address ______________________________________________________________
- ______________________________________________________________
- City ___________________________ State/Prov ________ ZIP __________
- Country ___________________________ Phone number _____________________
-
- VISA/MASTERCARD # _________________________________ Exp Date __________
- Signature _________________________________
-
- Shareware serial number displayed in the On-Call Summary Window _______
- Where did you obtain this copy of On-Call _____________________________
-
- Suggestions ___________________________________________________________
- _______________________________________________________________________
- _______________________________________________________________________
-
-
-
-
-
-
-
- 5
-
-
-
-
-
- TABLE OF CONTENTS
-
- 1. THE SHAREWARE DISTRIBUTION CONCEPT...............................7
-
- 2. INTRODUCTION.....................................................9
- 2.1 System Requirements........................................9
- 2.2 Quick Start Guide.........................................10
-
- 3. INSTALLATION....................................................12
- 3.1 Distribution Files........................................12
- 3.2 Floppy Disk Installation..................................12
- 3.3 Hard Disk Installation....................................12
-
- 4. LOADING On-Call.................................................13
- 4.1 Preliminary Considerations................................13
- 4.2 Starting The Program......................................14
- 4.3 Start-up Options..........................................14
- 4.4 Loading Resident Programs.................................18
- 4.5 The Summary Window........................................21
- 4.6 Errors While Loading Programs.............................22
-
- 5. USING On-Call...................................................23
- 5.1 Popping-up On-Call........................................23
- 5.2 Program Selection.........................................24
- 5.3 Running Other Software....................................28
-
- 6. ACCESSORIES.....................................................30
- 6.1 OCA.COM...................................................30
- 6.2 OCP.COM...................................................33
- 6.3 OCV.COM...................................................33
-
- 7. COMPATIBILITY...................................................34
- 7.1 Case of Mistaken Identity.................................34
- 7.2 Things to Avoid...........................................34
- 7.3 Hazards...................................................35
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 6
-
-
-
-
-
- 1. THE SHAREWARE DISTRIBUTION CONCEPT
-
- A major problem with buying software is that you generally need to put
- your money "up front" before you even get a chance to load and test
- most software packages. If after testing that software you find that it
- doesn't solve the problem YOU have or simply doesn't work, you may find
- yourself stuck with it and unable to get a refund. One way around this
- problem is the concept known as "Shareware".
-
- Shareware distribution allows you to obtain a full working copy of a
- program, load it into your own personal system and try it for a short
- time without incurring any financial obligation. If you find the
- software unsuitable, you simply erase the software or pass it on to
- another potential user. This doesn't mean that Shareware programs are
- in the public domain or may be used for free beyond a short evaluation
- period.
-
- Shareware programs, like most other software on the market, are
- copyrighted works and as such are protected by Federal and
- international copyright law. Their owners are entitled to be paid for
- continued use of these programs. But more importantly, you rely on the
- software you use and the support its authors provide. As a result you
- have a stake in their continued success. The Shareware concept
- provides for this through a mutually beneficial arrangement as outlined
- below.
-
- Benefits to you
- ---------------
- * Evaluation of software before actually having to pay for it
-
- * Easy access to new software and new software updates through
- a network of thousands of electronic bulletin boards around
- the country
-
- * Lower cost due to the reduced expenses for the developer
-
- * The ability to help your fellow computer owners by
- providing them with a copy for them to try for themselves
-
- Benefits to the software developer
- ----------------------------------
- * Simplified distribution and promotion of their product
-
- * Direct access to a wide range of users
-
- * Reduced marketing costs
-
- * More time to improve current products and develop new ones
-
- Shareware programs are financed by users "Registering" their copies.
- But why should you support Shareware and actually pay for something you
- already have? To begin with, it's the law. More importantly you will
- receive the additional benefits of having a registered copy.
-
-
-
-
- 7
-
-
-
-
-
- Benefits of supporting Shareware
- --------------------------------
- * You will receive:
- * A more detailed typeset manual with index and quick
- reference guides
-
- * An absolutely up to date copy of the program on a
- professionally labeled disk
-
- * Technical support via telephone
-
- * Automatic notification of updates and new software
-
- * You will ensure the continued refinement and support of
- the software on which you rely
-
- * You will encourage software developers to continue to
- provide high quality software as Shareware
-
- * You will help to keep the cost of quality software
- down by reducing the need of the developer to pay for
- expensive marketing
- In short, if you like the ability to test software before you buy it,
- you hate paying exorbitant prices and you want to share in the success
- of new and innovative software, then YOU should support Shareware!
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 8
-
-
-
-
-
- 2. INTRODUCTION
-
- Welcome to On-Call and the On-Call Shareware Documentation. By
- using this product you greatly expand your access to memory resident
- software and enhanced the capabilities of most other application
- packages. Within this document you will find all of the necessary
- information to implement On-Call and inspire solutions to long standing
- problems with PC/MS-DOS.
-
- Please take time to review this document and absorb its contents.
- However, if you feel the need to jump right in and see how On-Call
- works, proceed to the Quick Start Guide. For most users, getting this
- software up and running will be rather easy, but you won't gain the
- full benefit of On-Call until you have completely reviewed this manual.
-
-
- 2.1 System Requirements
-
- To run On-Call, your system must meet the following requirements. All
- efforts have been made to ensure the greatest degree of compatibility
- with a wide variety of hardware and software configurations. If there
- is any question about whether your particular configuration is
- acceptable, contact the On-Call Sales Department at 1-800-443-4134.
-
- Hardware Requirements
- --------------------
- * Any model Compaq computer or close compatible
- (i.e. IBM PC/XT/AT/PS2)
-
- * At least 256 Kilobytes of memory, 640 K suggested
-
- * 2 floppy disk drives or 1 floppy disk drive and a hard disk
- (A hard disk or large RAMdisk is a definite advantage)
-
- * A Monochrome, CGA, EGA or equivalent display adapter and Monitor
-
-
- Software Requirements
- --------------------
- * PC-DOS or MS-DOS version 2 or later
-
- * At least one properly installed and operational resident
- program
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 9
-
-
-
-
-
- 2.2 Quick Start Guide
-
- If you simply can't wait to try On-Call, follow these simple steps for
- a quick test drive. Remember though, to fully utilize the many
- features of On-Call, you must read the rest of this document. It will
- explain things that wouldn't otherwise be apparent. But for now...
-
- 1. Make a disk which contains all of the On-Call distribution
- files.
-
- 2. Insert a copy of that disk into drive A.
-
- 3. Select another drive where there is some space for On-Call to
- store its image data file and make that the default drive.
-
- NOTE: Only the "ONCALL.DAT" file will be placed in that
- location. You may remove it later.
-
- 4. Run the On-Call program.
-
- A:ONCALL
-
- 5. Wait for the Program Information Window.
-
- The "PgmPath:" field will be highlighted. Enter the path to one
- of your resident programs then press the "Enter" key.
-
- Example: C:\DOS
-
- 6. The "Program:" field will be highlighted. Enter the file name
- of the resident program you wish to load, with it's 3 letter
- extension, then press the "Enter" key.
-
- Example: PRINT.COM
-
- NOTE: Only .COM and .EXE files may be loaded
-
- 7. The "Options:" field will be highlighted. Enter any text,
- normally required after the file name when starting your
- resident program, then press the "Enter" key.
-
- Example: /Q:24
-
- 8. Do not enter anything following "DatPath:", just press
- "Enter". Later in this manual you will learn how and when to
- use this field.
-
- 9. Your resident program will then load into memory and be stored
- into the "ONCALL.DAT" disk file.
-
- 10. Perform steps 5 through 9 for each additional program you want
- to load.
-
- 11. After loading a few resident programs, press the "Esc" key and
- wait for the following pop-up window.
-
-
- 10
-
-
-
-
-
-
- 12. Use the cursor control keys to highlight the desired resident
- program then press "Enter". The highlighted program will
- be selected.
-
- 13. To select a different program while at the DOS prompt, run the
- program on the On-Call distribution disk called "OCP.COM".
- This will cause the Program Selection Window to be displayed.
-
- A:OCP
-
- 14. From within another application program, press and hold the
- "Ctrl" key, then press the Right Shift key. On-Call
- will acknowledge with a short beep then wait for an appropriate
- time to display the Program Selection Window.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 11
-
-
-
-
-
- 3. INSTALLATION
-
- Installation of On-Call is straight forward and may be obvious to many
- users. However, I do suggest that you read through this material to
- avoid missing information which may be helpful.
-
-
- 3.1 Distribution Files
-
- The Shareware version of On-Call is distributed in a single archive
- file. Included are the following files:
-
- READ.ME Current information about On-Call and the On-Call
- distribution files
-
- ONCALL.EXE The On-Call program
-
- OCP.COM A utility to facilitate switching resident programs
-
- OCA.COM The On-Call Accessory program
-
- OCV.COM A utility program to be used only as directed for
- solving compatibility problems.
-
- There may be other files not listed above. Examine the file named
- READ.ME for information regarding additional files and changes to
- On-Call.
-
- To display the READ.ME file type: TYPE A:READ.ME
-
- To print the READ.ME file type: COPY A:READ.ME PRN:
-
-
- 3.2 Floppy Disk Installation
-
- There are no installation procedures for you to perform prior to using
- On-Call on a floppy disk based system. However, it is imperative that
- you make at least one copy of the distribution files to protect
- yourself against total loss of this program and its associated files.
- The only other action you need to take before using the On-Call program
- is to prepare at least one formatted disk. This disk will be used to
- store the image data file which On-Call will create.
-
-
- 3.3 Hard Disk Installation
-
- To install On-Call on a hard disk, simply copy the distribution files
- to an appropriate directory. To avoid confusion, a separate
- subdirectory should be used for these files.
-
-
-
-
-
-
-
-
- 12
-
-
-
-
-
- 4. LOADING On-Call
-
- On-Call is so simple to use that you may overlook some of its more
- subtle features. Please take time to review all of this section. As
- you will see, a little planning and a general understanding of what
- On-Call can do for you will make use of this product much more
- beneficial.
-
-
- 4.1 Preliminary Considerations
-
- Before we actually get into using On-Call, lets take a quick look at
- the way we can handle a couple of special situations.
-
-
- Using Expanded/Extended Memory
- ------------------------------
- On-Call will allow you to place its image data file on any disk drive
- and in any subdirectory you desire. Because of this, you can instruct
- On-Call to create and maintain its data on a RAMdisk. Using a
- conventional memory RAMdisk for this purpose would be
- counterproductive. However, if it's located in Extended or Expanded
- Memory, above the 640K DOS limit, the advantage could be a vast
- improvement in speed over a floppy or hard disk drive.
-
- To use On-Call with an expanded memory RAMdisk, follow the instructions
- included with your expanded memory board or RAMdisk software to create
- the desired RAMdisk drive. Then refer to the Image Data File section
- under Start-up Options to learn how to inform On-Call where to locate
- the image data file.
-
- One problem with a RAMdisk is that it will not retain information when
- the power is turned off. In order to utilize On-Call's ability to
- reload resident programs from an image data file, copy the file to a
- floppy or hard disk drive prior to turning off your computer. If you
- create a batch file to do this and execute it each time before turning
- off your computer, you will be able to reload all resident programs
- without loosing their present status and data. If you are a hard disk
- user, it would also be a good idea to include in this batch file a
- command to park the heads of your disk drive. Don't forget to include
- a step in your AUTOEXEC.BAT file to copy the image data file back to
- the RAMdisk before starting On-Call
-
-
- Permanently Resident Programs
- -----------------------------
- There may be resident programs which you don't want to select with
- On-Call but would prefer to have available at all times. These
- programs should be loaded either before or after On-Call. However,
- On-Call would prefer that you use it to load all resident software so
- that it can keep things under control. Certain resident programs are
- rather unruly and conflicts may result from loading them independently
- of On-Call. If you decide to load another resident program this way,
-
-
-
- 13
-
-
-
-
-
- assure that it is working properly and cooperating with On-Call before
- getting back to work. Any known conflicts will be listed either in
- Chapter 6 or in the READ.ME file on the distribution diskette.
-
-
- 4.2 Starting The Program
-
- Once you have completed the installation procedures, you are ready to
- start On-Call.
-
- To start On-Call type: ONCALL
-
- NOTE: If you already have the image data file, called ONCALL.DAT, in
- the default directory, this command will cause it to be erased and a
- new file created.
-
- If you don't specify any options, either on the command line or via an
- environment parameter, On-Call will create the image data file in the
- current directory, on the current drive. It will not attempt to search
- for an existing image data file as with the automatic reload function
- described below. It will also default to using "Ctrl" and Right Shift
- as the Hot-Keys. To change any of these default conditions, or to tell
- On-Call to skip the file status screens, see the appropriate sections
- below.
-
- As On-Call starts up, it checks the current screen mode and adjusts
- itself accordingly. If you have your screen set to a color mode,
- On-Call will display in color. If the mode is black and white or
- monochrome, On-Call will use non-color attributes. If your screen mode
- is set either to a graphics mode or any mode not standard for CGA or
- Monochrome adapters, On-Call will not run. If you have any problems,
- check the description of the "MODE" command in your DOS documentation.
-
-
- 4.3 Start-up Options
-
- On-Call may be given special instructions by placing additional
- information on the command line or in an environment parameter. These
- instructions allow you to specify where On-Call should maintain its
- image data file, what to call the image data file, what Hot-Keys to
- use, whether to use an existing data file and whether On-Call should
- bother with message windows.
-
-
- Specifying Options
- ------------------
- You may specify start-up options on the command line as you start
- On-Call or prior to that with an environment parameter. The method you
- choose will depend on your particular needs and preferences, both have
- been provided for convenience.
-
- NOTE: The "<" and ">" characters indicate variable information. Do not
- include them when specifying options.
-
-
-
-
- 14
-
-
-
-
- Specify options when On-Call is started:
-
- ONCALL /D=C:\OC\ONCALL.DAT
-
- Specify options prior to starting On-Call:
-
- SET ONCALL=/R/A
- ...other commands...
- ONCALL
-
- NOTE: You must use "ONCALL" as the environment parameter or On-Call
- will not recognize it. Refer to your DOS documentation for more
- information on using the "SET" command and environment parameters.
-
- Each option begins with a "/". The letter following the "/" indicates
- which option. You may place them in any order. If the same option is
- found both in the "ONCALL" environment parameter and on the command
- line, On-Call will use the one specified on the command line.
-
-
- Image data file
- ---------------
- The image data file is where On-Call will keep any resident programs
- which are not currently in memory. When a program is selected, it's
- read out of this data file and placed into memory. When a program is
- deselected, it's saved back into this data file. This data file must be
- available when On-Call needs it. If you delete or inadvertently
- destroy the image file, or if at any time On-Call can't find it, no
- resident program will be selected. To keep things nicely organized,
- On-Call allows you to specify where it should find or create this file
- and what it should be called. If you don't specify, On-Call will call
- it ONCALL.DAT and place it in the directory and on the drive which is
- the default when On-Call is first started. If you have a hard disk,
- you may want to keep this file in the same directory as the On-Call
- program.
-
- Specify Image Data File: /D=<<path name>>
-
- To specify the drive and directory for the image data file, include
- this option on the command line when starting On-Call.
-
- Example: ONCALL /D=C:\OC\RP.DAT
-
- Note: If you use the "/D=" option you must specify the file name in
- addition to the drive and path. The examples above ensure that
- On-Call will maintain its data file called RP.DAT in the OC directory
- on drive C:. This option is quite useful in conjunction with the
- auto-reload option.
-
-
- Hot-Keys
- --------
- Once On-Call is loaded, it remains resident in memory but relinquishes
- control to DOS. The keys you use to inform On-Call that you want the
- selection menu are called the Hot-Keys. they are by default the "Ctrl"
- and Right Shift keys. A further explanation of how to pop-up on On-Call
-
-
- 15
-
-
-
-
-
- may be found in Chapter 4. Since many programs use a wide variety of
- key stroke combinations to give them commands, On-Call allows you to
- specify which keys you want for the Hot-Keys. This helps to avoid
- conflicts. Any combination of the "Alt", "Ctrl", Left Shift and Right
- Shift keys may be specified. You are required to press all the
- specified keys, at the same time, to bring up the On-Call selection
- window.
-
- Specify Hot-Keys: /H=A<L>
-
- The "/H=" option specifies the desired Hot-Keys. Follow this option
- with any combination of the letters A, C, L and R, where A represents
- the "Alt" key, C represents the "Ctrl" key and L and R represent the
- Left and Right shift keys respectively.
-
- Examples: ONCALL /H=AR
- or
- SET ONCALL=/H=AR
-
- The examples above will tell On-Call to pop-up the program selection
- window when both the "Alt" and Right Shift keys are pressed. This may
- be specified differently each time On-Call is started and may be
- different even though the same image data file is used.
-
-
- Automatic Reload
- -----------------
- An important feature of On-Call is its ability to reuse an image data
- file. This means that once you have run On-Call and have loaded the
- desired resident programs, you may never have to reload them again. It
- also means that your computer will be ready for use in a much shorter
- time than it would if it had to execute a long AUTOEXEC.BAT file.
- Using the automatic reload feature of On-Call brings the resident
- programs back exactly as you left them the last time your computer was
- on, including data!
-
- Specify Automatic Reload: /R
-
- The "/R" option instructs On-Call to automatically reload an existing
- image data file.
-
- Examples: ONCALL /R
- or
- SET ONCALL=/R
-
- To use the automatic reload feature, On-Call must be able to locate the
- existing image data file. If this file is not called ONCALL.DAT or is
- not on the default drive and in the default directory, you will have to
- specify its location and name with the "/D=" option.
-
- NOTE: To use the automatic reload feature, On-Call must load in EXACTLY
- THE SAME MEMORY LOCATION as when the image data file was first
- created.
-
-
-
-
- 16
-
-
-
-
-
- On-Call will only use the automatic reload feature if it is loaded in
- exactly the same memory location as when it first created the image
- data file. The best way to insure that memory locations match is to do
- everything exactly the same prior to starting On-Call as when you first
- created the image data file.
-
- If On-Call finds that it is not in the same memory location as before,
- it will not immediately destroy the file, but will ask if you want to
- continue. At this point you may back out and leave the old image file
- intact or continue on and let On-Call erase that file and start a new
- one.
-
- If you will be using AUTOEXEC.BAT to run On-Call with automatic reload,
- you should note that executing a batch file uses a small portion of
- memory and On-Call will be loaded into a slightly higher memory
- location. Actually, this is no problem. Simply setup your
- AUTOEXEC.BAT file and reboot your computer. If On-Call does not find an
- existing image data file, it will automatically create a new one. If
- On-Call finds an old image data file which can not be used, it will ask
- if you want to continue. When it does, answer with a "Y" and load the
- desired resident programs. The next time you turn on your computer,
- On-Call will see that the image data file is acceptable and use it.
-
-
- Adding New Resident Programs
- ----------------------------
- A major advantage of On-Call is its ability to "remember" resident
- programs and make them available, as they were last used, even if your
- computer has since been turned off. Once a resident program is loaded
- into On-Call you may never have to "load" it again. It would therefore
- be inconvenient to have to reload all of your resident programs simply
- to add a new one to the Image Data File.
-
- On-Call has a start-up option which may be used to add a new resident
- program to an existing Image Data File. For this option to be
- effective it must be used in conjunction with the Auto-Reload feature.
-
- Add a new resident program: /R/A
-
- The "/A" option instructs On-Call to request information on a new
- Resident program by displaying the Program Information Window. When
- the window is displayed, you may enter information on any number of
- new resident programs, then press "Esc" to finish loading On-Call.
-
- NOTE: Using the "/A" option without specifying "/R" has no effect and
- may result in overwriting the existing Image Data File.
-
-
- Bypass Message Windows
- ----------------------
- Whenever On-Call reads from or writes to the image data file, it will
- display a message window explaining what it's doing. This message
- includes the name of the image data file and which resident program is
- being loaded or saved. You may inform On-Call that you do not want
- these messages to be displayed.
-
-
- 17
-
-
-
-
-
-
- Bypass Messages: /M
-
- The "/M" option instructs On-Call not to display file access message
- windows.
-
- Examples: ONCALL /M or SET ONCALL=/M
-
- This option will not have any effect other than to prevent these
- messages from being displayed. You may decide to use this option
- when running On-Call on a faster machine, since the message windows
- will not be displayed long enough for you to read them.
-
-
- 4.4 Loading Resident Programs
-
- When On-Call does not perform an automatic reload, or if the "/A"
- start-up option has been specified, it will present you with a small
- form to fill out for each program you wish to load. Using this form,
- you have the option of loading a resident program into On-Call,
- executing a non-resident program, printing a list of programs which
- have already been loaded or accessing the context sensitive help
- screen.
-
- If you are using a hard disk drive or a large RAMdisk, you will be able
- to load as many resident programs as you would like. You may also load
- the same resident program more than once, if it makes sense to do so.
- For example, if you have an outliner which can be installed as a
- resident program, you may want to have access to several outlines at a
- time. While these programs generally allow multiple files to be loaded
- at the same time within different windows, doing so will often require
- a great deal more memory. With On-Call you can load different outlines
- into different copies of the outliner and easily switch between them.
-
- You might find this a bit extravagant if you're using a floppy disk
- drive to store the image data file, especially if it's a 360K drive. I
- should mention at this point that you may add, delete, rename or
- duplicate a program image using the OCA.COM accessory program. This
- means that you don't have to worry about which programs you want to
- load or how many times you want them loaded. The On-Call accessories
- are described in Chapter 5.
-
-
- Entering Program Information
- ----------------------------
- The form you will use to load programs into On-Call consists of four
- entry fields. Each of these fields are described in detail below,
- along with some examples. After you place the desired information
- into each field, press the "Enter" key and the cursor will advance to
- the next field. Pressing the "Enter" key while in the "DatPath" field
- will tell On-Call that you have entered all desired information and
- would like it to load the program. You will notice a program number at
- the bottom of the program information window. The maximum number of
- programs that you may load is 40. If you reach this limit, On-Call
- will automatically take you to the program selection window.
-
-
- 18
-
-
-
-
-
-
-
- PgmPath
- -------
- This field tells On-Call where it can find your program. It should be
- a complete path including a drive letter and any directories starting
- from the root directory. If it specifies the "root" directory, it must
- end with a "\", otherwise it should end with the directory name.
-
- Examples: A:\ C:\DOS D:\EDIT\PGM
-
-
- Program
- -------
- Here is where you place the full name of the program which you want to
- load into On-Call. Unlike executing a program from DOS, this name must
- include an extension which is either ".EXE" or ".COM". Sorry, ".BAT"
- files are not allowed. Do not include a drive or path, these should be
- placed in the "PgmPath" field.
-
- Examples: MODE.COM EDITOR.EXE
-
-
- Options
- -------
- With some programs you may be able to specify options or parameters on
- the command line. This is where you can place these options. On-Call
- will pass them on to the program, as it is loaded. In this field, place
- anything which would normally follow the name of the program when
- starting it from the DOS prompt. Spaces are allowed.
-
- Examples: LPT1:/m=32 /W:80
-
-
- DatPath
- -------
- If prior to loading a resident program, you normally change to a
- directory other than where the program resides, the path to that
- directory should be placed here. This may be desired when you want
- your program to access data files in another directory, without having
- to specify a path to that directory. As with the "PgmPath" field, you
- must use a complete path name, including the drive letter and any
- directories starting at the root directory. If the "DatPath" is the
- same as the "PgmPath", simply leave this field blank and On-Call will
- use the path which you have supplied in the "PgmPath" field.
-
- Examples: B:\ C:\EDIT\DATA
-
-
- Program Information Window Edit Keys
- ------------------------------------
- Certain keys have assigned functions which facilitate entering program
- information. These keys are listed below. Pressing an incorrect key
- or attempting to go beyond the bounds of an input field will cause a
- low warning beep to be produced, and no action taken.
-
-
- 19
-
-
-
-
-
-
- Move up one input field [Up Arrow]
-
- Move down one input field [Down Arrow]
-
- Move one character to the left [Left Arrow]
-
- Move one character to the right [Right Arrow]
-
- Move to the first character [Home]
-
- Clear input field [Ctrl-Home]
-
- Move to the last character [End]
-
- Move to "PgmPath" [Pg-Up]
-
- Move to the "DatPath" [Pg-Dn]
-
- Toggle insert and overwrite modes [Ins]
-
- Overwrite mode is indicated by a small cursor. Insert mode is
- indicated by a large cursor.
-
- Delete character at the cursor [Del]
-
- Delete character to the left of cursor [<--]
-
- Help key [F1]
-
- Once the relevant help screen has been displayed you may select
- the help menu by pressing the "Enter" key or return to the
- entry form by pressing "Esc".
-
- Print list of loaded programs [F9]
-
- Done, no more programs to load [Esc]
-
- If you do not have any programs loaded, this key will return
- you to DOS.
-
-
- Problems Loading Resident Programs
- ---------------------------------
- If for some reason On-Call is not able to locate or load a program, it
- will display the program information window with the information you
- supplied and produce a low error beep. On-Call makes a reasonable
- guess as to what might have gone wrong and places the cursor in the
- input field where it thinks the problem exists. If this occurs, you
- should check all input fields and make any necessary changes. On-Call
- may also display a message in the "Options" field indicating either
- that the program did not stay resident or that On-Call is not capable
- of handling the requested program. These messages are cleared using
- the "Ctrl-Home" combination described above.
-
-
-
- 20
-
-
-
-
-
- NOTE: Some programs must be told to remain resident. These programs
- may require an entry in the "Options" field.
-
-
- Executing Non-Resident Programs
- -------------------------------
- You may find that while you are loading resident programs into On-Call,
- you would like to run a non-resident program or execute a DOS command.
- This is easy to do and does not interfere with the process of loading
- resident programs. Generally the reason for doing this would be to
- obtain information on options for the program you want to load. Since
- On-Call recognizes when a program does not stay resident, it will cause
- no problems other than having to clear the input fields of any unwanted
- data before selecting another resident program.
-
- To execute a non-resident program from this window, simply supply any
- required information just as you would for a resident program. After
- you quit or exit the non-resident program, may use the "Ctrl" and
- "Home" keys together to clear each input field as you enter information
- for the next program. If you would like to execute a DOS command, run
- the program called COMMAND.COM. Running this program is similar to
- executing the "SHELL" command from BASIC. When you have finished
- executing any desired programs or DOS commands, simply enter "EXIT",
- just as you would to return to BASIC.
-
-
- When All Desired Programs Are Loaded
- ------------------------------------
- When All Desired Programs are Loaded When you have loaded all of the
- resident programs you want into On-Call and have pressed the "Esc" key,
- a program selection window will be displayed. This is the window you
- will use to select a resident program and is described later in this
- manual. For now, just press the "Enter" key, which will select "none"
- and advance On-Call to the summary window.
-
-
- 4.5 The Summary Window
-
- If every thing has gone according to plan, you will soon be presented
- with the On-Call summary window. This information will remain on the
- your screen and On-Call will terminate but still be resident in memory
- waiting for you to call upon it with the designated Hot-Keys. No action
- is require at this time and you are free to continue with whatever work
- you desire. Lets take a quick look at the information provided. All
- values are in Bytes except the version and serial numbers.
-
- Version & Serial number
-
- This information identifies the source of your Shareware copy
- of On-Call. Please have this information available when
- contacting Forest Hill Software to register your copy and
- include it in any correspondence. Unfortunately, we can
- only provide support to registered users of On-Call. You may
- contact our sales department for further information and may
- even begin receiving telephone support the same day.
-
-
- 21
-
-
-
-
-
-
- Total system memory
-
- This is the total memory as reported by BIOS. It is possible
- that this value may vary from the actual amount in your system.
-
- Memory free before loading
-
- This is the amount of memory which was free before starting
- On-Call.
-
- Total for loaded programs
-
- Here is the number of bytes which would have been used by all
- of the programs, had you not loaded them with On-Call. This
- value may be larger than your total system memory!
-
- Actual memory required
-
- This is the memory which has been allocated for use by
- On-Call. It is the size of the largest resident program plus
- the size of On-Call itself.
-
-
- Memory savings realized
-
- This is the difference between the total for loaded programs
- and actual memory used. It's one measure of the benefits of
- On-Call.
-
- Following the summary display is a short legal announcement which
- reminds you that this is copyrighted material and subject to the terms
- stated herein.
-
-
- 4.6 Errors While Loading Programs
-
- Errors are a fact of life, but On-Call will help to soften the blow as
- much as possible. We have already explained what happens when the
- specified path or program cannot be found and how On-Call handles
- non-resident or unusable programs. But what happens when you specify a
- disk drive that has no disk in it or when you try to print to a printer
- which is off-line? Fortunately, On-Call will notice this and present
- you with a small Pop-Up error window. The best action to take if this
- happens is to try to correct the situation and press the "R" key to
- Retry. When it is not possible to correct the problem, press the "I"
- key to Ignore the operation. In either case On-Call will either
- continue as if nothing has happened or it will return you to where you
- were before the problem occurred.
-
- NOTE: There is a delay before this error window is displayed. This
- delay may be as short as few seconds for a floppy disk drive which is
- not ready or as much as 15 seconds for an off-line printer. The delay
- is within DOS, not On-Call. Don't be too quick to reboot your system
- when you don't see anything happening.
-
-
- 22
-
-
-
-
-
- 5. USING On-Call
-
- In this chapter you will find out how to use On-Call. The following
- information explains how you can get On-Call to pop-up and how to
- switch between different resident programs, both from the DOS prompt
- and from within an application program.
-
-
- 5.1 Popping-up On-Call
-
- There are two ways to call upon On-Call. One is for use only at the
- DOS prompt, the other is for use at all other times. With either
- method, you will frequently observe a short delay between the time you
- ask On-Call to pop-up and when it actually does. This is quite normal
- and is part of a statistical protection scheme which is used to ensure
- that On-Call does not switch a resident program out at an inappropriate
- time. If this scheme were not employed, your system would most likely
- take a vacation each time On-Call switched resident programs.
-
- While most resident programs don't seem to be doing anything most of
- the time, there is quite a flurry of activity taking place, without so
- much as the touch of a key to start it. Please be patient with On-Call
- and it will serve you well.
-
- As you become familiar with On-Call, you will realize that trying to
- switch resident programs while they are displaying on the screen is not
- a very good idea. While On-Call can usually tell if the resident
- program, which it currently has loaded, is popped-up, We don't suggest
- that you regularly test that capability. However, if you do make a
- mistake and press the Hot-Keys while the loaded program is "Up",
- On-Call will make every attempt to prevent disaster.
-
- Popping On-Call From DOS
- ------------------------
- Unlike most other resident programs you may be familiar with, you can
- not activate On-Call while at the DOS prompt simply by pressing the
- designated Hot-Keys. Instead, a small program has been provided on the
- On-Call distribution diskette which can be used to pop-up On-Call.
- This program is called OCP.COM. It should either be placed in a
- directory listed in your "PATH" statement (see your DOS documentation)
- or a "PATH" to it should be included. This way you will be able to
- activate the On-Call program selection window from within any
- directory.
-
- If using the "OCP" command is awkward, you may rename OCP.COM to any
- name that may be more convenient for you, as long as it has a ".COM"
- extension. You may also use the following alternative method to
- convince On-Call to pop-up from the DOS prompt. Press the designated
- Hot-Keys, "Ctrl" and Right Shift by default, then execute the DOS "DIR"
- command. At some point, either during disk access or writing to the
- screen, On-Call will find an opportune moment and come to life. On-Call
- may be more or less willing to pop depending on the currently selected
- resident program. While I have not yet run across such a program, it is
-
-
-
- 23
-
-
-
-
-
- possible to write one which could keep On-Call waiting forever. If you
- have a program which does this, check the "READ.ME" file on your
- distribution disk.
-
- To pop-up On-Call at the DOS prompt type: OCP
-
-
- Popping On-Call From Within Programs
- ------------------------------------
- While running an application program, you can pop-up On-Call simply by
- pressing the designated Hot-Keys. By default, these Hot-Keys are the
- "Ctrl" and Right Shift keys. Press both of these keys at the same time
- then release them to activate On-Call. If you have selected a different
- combination of keys using the "/H=" option, you must press those keys
- instead.
-
- You will notice that when you press the designated Hot-Keys, a short
- "Beep" will be produced. This is On-Call acknowledging your request.
- Before On-Call can proceed you must first release all keys. When
- On-Call pops, it will produce a lower tone telling you that it is ready
- to select a program. This may seem superfluous until you try to pop-up
- On-Call while a graphics screen displayed.
-
- Depending on the software you are running, On-Call will either be easy
- to pop or a bit stubborn. This is a result of the protections we
- discussed earlier. If On-Call does not pop after a few seconds,
- continue on with your work. It will most likely pop-up after a few key
- strokes. In extreme cases, it may be necessary to try some other
- action, such as disk access. A fairly effective method is to ask the
- software you are using to display a help screen. This generally will
- not interfere with your work and is easy to return from when you're
- done with On-Call.
-
-
- 5.2 Program Selection
-
- This section describes how you can switch between resident programs.
- There are two methods of selecting a resident program. One is used
- when the display is set to a standard text mode. The other is used
- when the display is set to a graphics or non-standard text mode.
- However, there is a common thread between these methods regarding use
- of the "Esc", "Enter" and "Crtl-Enter" key sequences. These allow you
- to keep the selected resident program, save the selected resident
- program, save the selected resident program and switch to a different
- one or forget the selected resident program and switch to a different
- one. Exactly how to perform these functions is described in detail
- below.
-
-
- Text Mode Selection
- -------------------
- When On-Call is popped-up, if your screen is in a text mode which is
- standard for either a Monochrome or CGA adapter, you will see On-Call's
- Resident Program Selection window. At any one time, this window will
- display the names of 12 resident programs loaded into On-Call. The
-
-
- 24
-
-
-
-
-
- currently selected program or "(none)" will either be highlighted or
- displayed in reverse video.
-
- Since On-Call allows you to load the same program more than once, it
- must be able to identify each copy. It identifies duplicates by
- including a parenthesized number after the program name and will treat
- them as totally separate entities. You can rename these duplicates
- using the OCA.COM accessory program. Doing so will make it easier to
- identify each copy. The OCA.COM program is described in Chapter 5.
-
- Selecting the desired resident program is basically a Point-and-Shoot
- procedure. The selection screen can only display 12 program names at
- one time, while On-Call can manage up to 40. If the program you want to
- select is not shown on the display, simply move in the direction of
- that program and the list will "Scroll", exposing the unseen programs.
-
- The following is a list of the keys you may use while the selection
- window is displayed. Pressing an illegal key or attempting to go
- beyond the limits of the listed programs will cause On-Call to produce
- a low warning beep and ignore that keystroke.
-
-
- Program Selection Keys
- ----------------------
- Move up one program [Up Arrow]
-
- Move down one program [Down Arrow]
-
- Move one to the left, with column wrap [Left Arrow]
-
- Move one to the right, with column wrap [Right Arrow]
-
- Move to the first program listed [Home]
-
- Move to the last program listed [End]
-
- Move up 12 programs [Pg Up]
-
- Move down 12 programs [Pg Dn]
-
- Save current program, select highlighted [Enter]
-
- Switching programs in this way will ensure that when you return
- to a resident program it will be exactly as you left it.
- On-Call will recognize if you are re-selecting the currently
- selected program and not unnecessarily read it back in from the
- image data file. Doing this occasionally is roughly equivalent
- saving your work within the constructs of your resident
- program, and may be faster.
-
- Forget current program, select highlighted [Ctrl-Enter]
-
- This sequence is used when you want to change programs but
- don't want the currently selected resident program to be saved
-
-
-
- 25
-
-
-
-
-
- to the image data file. You may also use this function to avoid
- saving changes you have made. In fact, if you have the
- currently selected program highlighted when you press these
- keys together, you will have returned that program to the state
- it was in the last time you selected it.
-
- Display context sensitive help information [F1]
-
- Pressing this key will display a screen of information related
- to selecting a resident program. To access the Help menu, press
- "Enter" then the letter shown for the desired help screen. The
- "Esc" key will return you to program selection.
-
- Print a list of loaded programs [F9]
-
- Exit without making any changes [Esc]
-
- Use the graphics mode "Blind" selection method [G]
-
- You may have to use this command when running On-Call with
- certain graphics programs. If the display is in graphics mode
- when you Pop-Up On-Call and you see random nonsense at the top
- of the screen, press the "G" key. On-Call will restore the
- screen and begin using the graphics mode selection method
- described below.
-
- When you select the desired resident program, On-Call will perform any
- required disk access to save the current program and/or select the new
- one. Unless you specified the "/M" option or are working in a graphics
- mode, a status window will indicate what On-Call is doing as it
- proceeds. If you keep the image data file on a RAMdisk or a fast hard
- disk, you may not have time to read these messages. On the other hand,
- if you are using a 720K Microfloppy drive, it should give you something
- to do while you wait.
-
- When On-Call is done, it will produce a characteristic three tone
- sequence indicating that it is safe to proceed with your work. Please
- wait for this indication before proceeding.
-
-
- Non-Text Mode Selection
- -----------------------
- Unlike some other resident programs, On-Call does not attempt to
- interact with the display when it is in a graphics or non-standard text
- mode. This doesn't mean that it won't work. However, it does mean
- that resident program selection takes place "Blind". The process is
- directed by different "Beeps" which are easy to recognize and guide you
- through the process. You should carefully follow the procedure below
- the first time through, after that it will quickly seem natural.
-
- 1. Pop-Up On-Call with the designated Hot-Keys
-
- Just as it does in text mode, On-Call produces two beeps before
- displaying the program selection window. These beeps, which may
-
-
-
- 26
-
-
-
-
-
- have seemed unnecessary in text mode, will let you know when
- On-Call is ready for you to enter the desired program name.
-
- Some graphics programs do not conform to all DOS conventions.
- With certain graphics programs, On-Call may not be aware that
- the display is set to a graphics mode and attempt to display
- the program selection window. If this happens, the screen will
- partially fill with random nonsense. When you see this happen,
- or if after popping On-Call, it does not seem respond to you
- key strokes, press the "G" key. On-Call will then restore the
- screen and begin using the "Blind" selection method.
-
- 2. Enter Desired Program Name
-
- When typing the program name, include the extension (.EXE or
- .COM) or On-Call will not be able to find your program. Do
- not include any parenthesized numbers. If you get lost trying
- to type the program name, use the Rubout key (above the Enter
- key) to back up to the point at which On-Call produces the low
- tone error beep. That will indicate that you have deleted all
- of the characters typed so far. Program names can be up to
- 12 characters long. If you type too many characters On-Call
- will produce the low tone error beep and ignore your key
- strokes.
-
- The process of matching the name you type to the list of loaded
- programs is "Case Sensitive". This means that a capital letter
- is not considered to be the same as a small letter. This will
- be important to remember once you have changed a program name
- with the OCA.COM accessory program.
-
- If you only want to save the program which is currently
- selected, do not enter the program name.
-
- 3. Press either "Enter" or "Ctrl-Enter"
-
- The effect is the same as for text mode selection. If you press
- "Enter", the currently selected program will be saved.
- Pressing "Ctrl" and "Enter" together will not save the
- current program before selecting the new one.
-
- If On-Call locates the desired program, it will confirm that
- with a high tone beep and proceed to switch to that program.
- Since you will be in a graphics or non-standard text mode, no
- status windows will be displayed. Please wait for the
- characteristic three tone sequence indicating that On-Call is
- done.
-
- If On-Call can't find a program with the name you supply, it
- will produce a low error beep. At this point you may retype the
- program name or print a list of currently loaded programs by
- pressing "F9".
-
-
-
-
- 27
-
-
-
-
-
- Pressing the "Ctrl" and "Enter" combination without first
- typing a program name will select "none". You may optionally
- type the word "none" and press "Enter".
-
- 4. If More than 1 high beep, enter copy number
-
- On-Call produces one high beep for each program matching the
- entered name. If it only finds one matching program, that
- program will be selected. If you hear more than one high beep,
- On-Call will be waiting for more information. Type the
- number of the copy you wish to select then press "Enter". You
- must wait for the three tone sequence indicating that
- On-Call is done.
-
- If you type an invalid number, On-Call will produce a low tone
- error beep and you will have to reenter the program name.
-
- At any time you may press "Esc" to quit resident program
- selection. Doing so will preserve the currently selected
- program unless you have already used the "Ctrl-Enter"
- combination to enter a program name.
-
-
- Printing a List of Loaded Programs
- ---------------------------------
- While loading or selecting programs, you may press the "F9" key to
- print a list of resident programs which are currently loaded. This
- list will include the name and size of each program, the total for all
- programs, the path and name of the image data file and the designated
- Hot-Keys. You may want to print this list once and keep it handy,
- especially if you frequently work in graphics or non-standard text
- modes.
-
- If your printer is off-line when you try to print this list, the error
- window will pop-up. It will then wait for you to press either "R" for
- Retry or "I" for ignore. Unfortunately, Ignore only bypasses one
- character at a time, which would be rather inconvenient in this case. I
- therefore suggest that you set the printer on-line and press "R" for
- Retry.
-
-
- 5.3 Running Other Software
-
- There is nothing special that you have to do while On-Call is loaded,
- other than the procedures above for switching resident programs within
- On-Call. Operation of your nonresident software will only be changed
- by the added functionality you will receive from having On-Call
- managing your resident programs.
-
- When On-Call is not popped-up, you are free to conduct business as
- usual. However, there is one thing you may occasionally notice. Some
- resident software is rather difficult to manage. In an effort to keep
- things under control, On-Call may, at it's discretion, store away your
- currently selected resident program and go to a "none" selected status.
- This will only happen with certain resident programs and only when you
-
-
- 28
-
-
-
-
-
- are starting a program. Please note that On-Call does not ask for
- permission to save your resident program. If you don't want it saved in
- it's present state, you will have to deselect it manually before
- starting the new program.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 29
-
-
-
-
-
- 6. ACCESSORIES
-
- The On-Call distribution files include several programs in addition to
- On-Call itself. One of these programs enhances the capability of
- On-Call by allowing you to add, delete, duplicate and rename resident
- program images. With the same program you may set certain default
- values for On-Call, such as Hot-Keys, protection level, display of disk
- access messages and how On-Call will handle each system interrupt.
- Other programs allow easy access to On-Call from DOS and solve
- compatibility problems. This chapter will describe each of the On-Call
- accessory programs and how to use them. Please note that some features
- of these accessory programs are only to be used as described in the
- supplied documentation, READ.ME file, or under the direction of the
- On-Call Customer Service Department.
-
-
- 6.1 OCA.COM
-
- The OCA.COM program is the largest of the On-Call accessories. This
- program will allow you to manipulate resident program images and set
- default values for ONCALL.EXE. Before you start this program, use the
- DOS "CD" command to change to the directory containing the ONCALL.EXE
- program. The OCA program expects to find ONCALL.EXE in the default
- directory. If the program isn't found, you won't be able to use any of
- the options under the "Configure On-Call" main menu selection.
-
- To Start OCA type: CD \OC
- (or directory containing On-Call)
- OCA
-
- You will be informed if there is any problem locating or reading
- ONCALL.EXE.
-
- WARNING: Please read all message windows carefully as they may provide
- important information.
-
- When the program has been loaded and ONCALL.EXE has been examined, OCA
- will provide you with the main menu. This menu has three options,
- "Edit Program Image File", "Configure On-Call" and "Quit Accessories".
- You make your selection either by using the arrow keys to highlight
- the desired option and then pressing the Enter key, or by typing first
- letter of the desired option. All subsequent menus operate in the same
- way, except that they are vertical as opposed to horizontal.
-
-
- Edit Program Image File
- -----------------------
- From the "Edit Program Image File" menu, you may list the contents of a
- file, erase an image, duplicate an image, add an image from another
- file or rename a program image. To return to the main menu press Esc.
- When selecting an option from this menu, you will be asked for a file
- name. Be sure to enter the full path and file name or OCA will not be
- able to locate the data file. Then press Enter. The above window is
- also used for several other options. Since the ":\" is always
- required, it is automatically provided for your convenience. OCA will
-
-
- 30
-
-
-
-
-
- display an error message if it can't find the desired file or has a
- problem reading it.
-
- Options on the Edit Program Image File Menu are:
-
- List Image File
-
- This option lists the images in the specified image file.
- With each image name is the number of bytes required for
- that program. Statistics for the entire file are listed at
- the top.
-
- Erase an Image
-
- This option allows you to remove an image from an image
- data file. This may be required if a problem has developed
- with that program and the image is no longer useful. You
- may also use this option to remove a program which is
- no longer needed. Follow the instructions provided on the
- screen to select and erase an image.
-
- Duplicate an Image
-
- This option will create two identical images from one
- which already exists. After creating the new image, OCA
- will scan through the list of images and renumber any
- duplicates as necessary. You should then use the "Rename an
- Image" option to specifically identify each copy.
-
- Copy an Image
-
- This option will copy an image from one file to another.
- This allows you to add a new image to an existing file.
- The images from both files must have been loaded in
- exactly the same way or OCA will refuse to copy the image.
- You may check the "Base Address" of both files with the
- "List Image File" option to see if they match.
-
- NOTE: See the "/A" start-up option for information on how
- to add a new resident program to an image data file.
-
- Rename an Image
-
- This option will allow you to assign a logical name to an
- image. The new name may contain any desired characters
- or punctuation but may not be more than 12 characters long.
- You can then refer to an image by its logical name rather
- than its original program name. Using short, or even 1
- letter names, will simplify selecting a resident program
- in the graphics selection mode.
-
- If you erase or duplicate an image, the entire image data file will be
- copied and the original file will be renamed with the extension ".BAK".
- If there is a problem during one of these operations, the resulting
- file may be unusable or nonexistent. If this happens, or you simply
-
-
- 31
-
-
-
-
-
- change your mind, delete the new file and rename the ".BAK" file to its
- original name. Erasing or duplicating an image will require enough disk
- space to copy the entire image data file. Floppy disk users may find
- this an insurmountable limitation, for which we apologize. OCA will
- fail the operation if the space is not available and leave the ".BAK"
- file intact.
-
-
- Configure On-Call
- -----------------
- From the "Configure On-Call" menu you may set default parameters and
- adjust how On-Call operates. Certain options in this menu should be
- used with caution or only with specific directions. These options will
- only be available if OCA was able to find the ONCALL.EXE program in the
- default directory. OCA will also refuse access to any of these options
- if it finds unexpected or inconsistent data.
-
- WARNING: Please read the information below before experimenting.
-
- Options on the Configure On-Call Menu are:
-
- Hot-Keys
-
- This option will allow you to set the default Hot-Keys
- for On-Call. Once set, this default may be overridden with
- the "/H" option when starting On-Call or in the ONCALL
- environment parameter. Follow the instructions provided
- by OCA to set the desired keys.
-
- Bypass Messages
-
- On-Call displays a message window each time the disk drive
- is accessed. On a faster system, you may not have time
- to read these messages and therefore may not want to bother
- with them. This option allows you to deactivate these
- messages. Once set, this default may be overridden with the
- "/M" option when starting On-Call or in the ONCALL
- environment parameter.
-
- Protection Level
-
- On-Call resists popping-up when the selected resident
- program is in some way active. This option sets a relative
- level of protection. The higher the number, the more
- resistant it is to popping. As distributed, this level is
- set to 2 which is moderate protection. The maximum
- value of 100 will make it almost impossible to access
- On-Call once a program is selected. If you find that your
- computer occasionally "hangs", either when popping or
- exiting On-Call, you should set this level a little
- higher. Try increments of 5 or 10.
-
-
-
-
-
-
- 32
-
-
-
-
-
- Interrupts
-
- This option should only be used when specifically
- directed by the On-Call documentation, READ.ME file, or
- Customer Service Department.
- WARNING: Making indiscriminate changes to the interrupt
- handling of On-Call will most assuredly result in disaster.
-
-
- 6.2 OCP.COM
-
- The OCP.COM program provides access to the On-Call program selection
- window from the DOS prompt. Its use has already been discussed in
- Chapter 4. You should make this program available by including a path
- to it in the "PATH" statement of your AUTOEXEC.BAT file. You may find
- that OCP has trouble popping-up the program selection window when you
- have certain resident programs selected. If this occurs, check the
- protection level described above.
-
-
- 6.3 OCV.COM
-
- The OCV.COM program solves a particular type compatibility problem with
- certain types of software. Quite simply, OCV allows these programs to
- "See" other related programs. Refer to the READ.ME file on the On-Call
- distribution diskette for information about specific software which
- requires use of this accessory program.
-
- WARNING: Use OCV.COM only as specified in the READ.ME file or as
- directed by the On-Call Customer Service Department.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 33
-
-
-
-
-
- 7. COMPATIBILITY
-
- Unlike most software programs, On-Call does not function totally on its
- own. Its job is to juggle other software in a way their authors may
- not have considered. While every attempt has been made, and will
- continue to be made, to accommodate the wide variety of resident
- software, compatibility problems may arise. Please take the time to
- ensure that your resident and non-resident software is cooperating with
- On-Call.
-
-
- 7.1 Case of Mistaken Identity
-
- Some software programs get their high performance by directly
- controlling the hardware in your system. Well behaved programs will
- inform BIOS and DOS of any changes which may affect other software.
- Some not so well behaved programs do not. It can be difficult, at times
- impossible, for other software to determine exactly what has been done
- by these programs and what state the hardware may be in. As a result,
- other software may tend to behave in a way inconsistent with the actual
- hardware state.
-
- On-Call has been written to comply with accepted rules and it's overall
- compatibility with other software is a testimonial to that. It can
- however be fooled by another program's slight of hand. One case in
- particular is graphics software which does not inform BIOS of the
- current state of the display. When running these programs, On-Call may
- mistakenly assume the wrong display mode and attempt to display the
- text mode selection screen on a graphics mode display. The result will
- be random nonsense at the top of the screen or no effect at all. If
- this happens simply press "G" to inform On-Call that you would like to
- use the graphics mode "Blind" selection method. When you do this,
- On-Call will restore the screen to normal and use "Blind" selection.
-
-
- 7.2 Things to Avoid
-
- Certain types of resident software won't make sense to load with
- On-Call. Others may have problems simply because they will be switched
- in and out of memory. Certainly, utilities such as disk caching
- programs will be dangerous to disable indiscriminately. These programs
- have become quite popular to speed disk access on floppy disks and the
- slower hard disk drives which have flooded the market. Deselecting this
- type of program, especially from within application software, could
- result in loss of data or corruption of the storage media. I suggest
- you load these programs prior to starting On-Call. This way they will
- always be in charge of disk access and may even speed switching
- resident programs with On-Call. Please feel free to try loading these
- programs into On-Call, but it may be a good idea to do so with a disk
- that is properly backed up.
-
- Other problem programs may be difficult to identify. Some software
- will become confused if there are changes to the system hardware or
- software status while they're switched out. These may be programs which
- work with serial or parallel I/O ports such as communications programs
-
-
- 34
-
-
-
-
-
- or network drivers. Others might not be able to handle an unexpected
- change in display status. A typical example would be a spelling checker
- which was not in memory when the word processor was changed from
- overwrite to insert mode. This is not to say that these programs
- can't be managed with On-Call, in fact the trade-off in memory savings
- may be worth the added attention they will require.
-
- Another consideration is related to performance. It might be best to
- run programs which require extremely fast response and processing of
- interrupts without On-Call loaded. While the overall impact on
- performance is generally minimal, the time required to respond to
- hardware interrupts could occasionally be affected. Any high speed
- data acquisition or communications programs should be fully tested
- with On-Call before they can be considered reliable.
-
-
- 7.3 Hazards
-
- Several ways of getting into trouble with On-Call have been covered in
- this manual. If you follow these rules, the chances of having problems
- will be greatly reduced.
-
- Don't rush On-Call
-
- Typing ahead of the software may save some time, but doing so
- when loading programs into On-Call could spur unnecessary
- activity and conceivably cause trouble. Also, don't rush to
- help pop-up On-Call. The less that is going on, the sooner it
- will be able to find an opportune moment. If after a few
- seconds it still doesn't pop-up, proceed with other measures.
-
- Don't switch programs while the selected program is on the screen
-
- The chances of On-Call popping-up at such a time is slim, but
- if you are successful, the penalty could be having to reboot.
- If you do find the On-Call selection menu pops over the
- selected program, you should press the "Esc" key to exit back
- to that program.
-
- Be careful about changing disks
-
- Don't change diskettes in the middle of a program simply to
- satisfy On-Call. If the program you are running doesn't perform
- disk access, you may be safe. Otherwise, it is possible to
- corrupt either or both diskettes. Try to plan your disk usage
- so that this kind of a swap will not be necessary. If On-Call
- doesn't find the image data file when trying to switch
- programs, it will go to a "none" selected status and return to
- the program which was interrupted.
-
- Use OCV.COM only as directed
-
- The OCV.COM program circumvents some of the interrupt
- monitoring which is critical to safe use of On-Call. You should
-
-
-
- 35
-
-
-
-
-
- restrict use of this program to that specified in the On-Call
- documentation, READ.ME file or by the On-Call Customer Service
- Department.
-
- Use OCA Interrupts option only as directed
-
- The Interrupts option of the OCA.COM program is intended to be
- used only as specified in the On-Call documentation, READ.ME
- file or by the On-Call Customer Service Department. If you
- make unauthorized changes to the interrupt settings, do not
- expect On-Call to function properly.
-
-
- ( End of Shareware Documentation )
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 36
-